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TECHNICAL FIELD 

This invention relates to computer-implemented systems for managing imaging 
. devices, such as digital cameras, scanners, and the like. This invention also relates to 
graphical window user interfaces, arid particularly to user interfaces used to facilitate 
capture and storage management of digital images. This invention further relates to 
operating systems and browsers that incorporate image device managers and user 
interfaces. 

BACKGROUND 

Digital imaging devices, such as scanners, cameras, video cameras, have been 
experiencing rapid growth in popularity as their price tags continue to decrease. 
Recreational photographers enjoy capturing pictures and videos and placing the digital 
files onto their computers for printing or emailing to friends and relatives. Businesses 
use scanners to digitally record documents used in day-to-day operation for archival 
purposes. ' 

Other solutions to this problem already exist. For example, TWAIN and ISIS are 
two image acquisition systems that are available today. However, both of these solutions 
have problems. TWAIN lacks robustness and interoperability. ISIS is a proprietary 
design that renders it difficult to use with other applications. 

Accordingly, a task set before the inventor was to create an image acquisition 
system that was based on an open architecture model and could be integrated with 
existing applications and operating systems to provide a convenient environment for the 
user. 
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SUMMARY 

This invention concerns an image acquisition system that offers an open 
architecture to integration with existing operating systems and other applications. 

In an exemplary implementation, the image acquisition system is implemented on 
computer, such as a desktop personal computer, having a processing unit, memory, and 
operating system. One or more imaging devices are coupled to the computer. Examples 
of the imaging devices include a scanner, a digital camera, a digital video camera, and so 
forth. Some imaging devices, such as digital cameras, have a device memory and are 
capable of capturing a digital image and storing the image on its memory. Other imaging 
devices, such as scanners, may not have their own device memory. 

The image acquisition system further includes an image device manager that is 
implemented in software on the computer to control operation of the imaging devices. 
The image acquisition system presents a user interface (UI) within the familiar graphical 
windowing environment. The UI presents a graphical window having a context space 
that pertains to a particular imaging context (e.g., scanning, photography, and video). In 
the camera context, the context space presents image files stored on the camera memory 
and/or on the computer memory. In the scanner context, the context space includes a 
preview scan area that reveals a preview of the image in the scanner. In the video 
context, the context space presents video clips stored on the computer memory, but 
logically represented as belonging to the video camera. 

The UI also has a persistently visible imaging menu positioned within the context 
space that lists options particular to an imaging context. For example, if the context 
space pertains to the camera context, the menu lists options to take a picture, store a 
captured image on the computer, , send the image in an email, and so on. In the scanner 
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context, the menu lists options to select an image type, preview an image, send the image 
to a particular destination, and scan the image. 

The image acquisition system also includes a set of application program interfaces 
(APIs) that expose image management functionality to applications. The APIs enable 
applications to manage loading and unloading of imaging devices, monitor device events, 
query device information properties, create device objects, capture images using the 
devices, and store or manipulate the images after their capture. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Fig. 1 is a block diagram of an image acquisition system. 

Fig. 2 is a block diagram of a software architecture for the image acquisition 

system. 

Fig. 3 is a diagrammatic illustration of a graphical user interface window showing 
integration of the image acquisition system within a familiar file system setting. 

Fig. 4 is a diagrammatic illustration of a graphical user interface window showing 
an opening window for managing imaging devices. 

Fig. 5 is a diagrammatic illustration of a graphical user interface window for 
interfacing with a scanner. 

Fig. 6 is a diagrammatic illustration of a graphical user interface window for 
interfacing with a digital camera. 

Fig. 7 is a diagrammatic illustration of a graphical user interface window for 
interfacing with a digital video camera. 

BRIEF DESCRIPTION OF THE APPENDIX 
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An attached appendix forms part of this document. The appendix contains a 
description of methods implemented in an image acquisition API (application program 
interface) utilized by the image acquisition system. 

DETAILED DESCRIPTION 

This invention concerns a computer-implemented image acquisition system that 
manages imaging devices (such as digital cameras, scanners, digital video cameras, and 
the like) and the images captured by them. In a preferred implementation, the image 
acquisition, system is implemented in a general-purpose computer (e.g., personal 
computer, laptop, etc.) to manage imaging devices attached locally to the computer or 
coupled remotely via a network. The image acquisition system supports a graphical user 
interface windowing environment that integrates image device management with the 
same look and feel of familiar browsing user interfaces for conventional file systems. In 
this manner, a user encounters a familiar experience when managing the imaging devices 
and image files from his/her computer. 

Exemplary System Architecture 

Fig. 1 shows an image acquisition system 20 having a computer 22. coupled to 
multiple imaging devices 24-30. The computer 22 is a general-purpose computing device 
that is described and illustrated, for discussion purposes, as a desktop personal computer 
(PC). The computer 22 has a processing unit 40, a volatile memory 42 (e.g., RAM), a 
non-volatile data memory 44 (e.g., disk drive, etc.), a non-volatile program memory 94 
(e.g., ROM, disk drive, CD-ROM, etc.), a display 48 (e.g., VGA monitor), and a 
universal serial bus (USB) 50. An operating system/browser 52 is stored in program 
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memory 46 and executed on the processing unit 40 when the computer is booted. 
Examples of suitable operating systems 52 include the Windows-brand operating systems 
from Microsoft Corporation and the operating systems from Apple Computer. Although 
a USB 50 is shown and described, other bus architectures may be used, including general 
serial buses, a SCSI bus, an IEEE 1394 serial bus that conforms to the IEEE 1394 
specification, and so forth. 

The imaging devices 24-30 are coupled to the computer via a serial connection to 
the USB 50. Illustrated examples of the imaging devices include a scanner 24, a video 
camera 26, and a digital camera 28. However, other imaging devices (e.g., copiers, 
facsimile machines, etc.) may also be used in conjunction with aspects of this invention, 
as represented by the generic imaging device 30. Some of the imaging devices have their 
own memory, as represented by memory 32 in imaging device 30. For example, the 
digital camera may have its own memory, whereas the scanner typically does not have a 
memory. 

The image acquisition system 20 includes an image device manager 60, which is 
implemented as a software component loaded on the computer 22. More particularly, the 
image device manager 60 is stored in program memory 46 and runs on processing unit 40 
during execution. The image device manager 60 may be integrated into the operating 
system 52 (as shown), executed as a set of services, or implemented as a separate self- 
contained program. 

The image acquisition system 20 also has a user interface 62, which is preferably 
a graphical user interface that presents a graphical window having a context space 
pertaining to the imaging context. Depending upon the particular context, the context 
space may list available imaging devices for which device drivers have been loaded onto 
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the computer, or list digital image files captured by one or more of the imaging devices, 
or show an image being scanned in by the scanner. 

The user interface 62 further presents a persistently visible imaging menu 
positioned within the context space. The imaging menu lists options that are particular to 
controlling the various imaging devices. For instance, when the context space pertains to 
the camera context, the menu lists a "Take Picture" option that is specific to operating the 
digital camera 28. Upon user selection of "Take Picture", the image device manager 60 
directs the digital camera 28 to record the current image obtained through the camera 
lens. In the scanner context, the menu lists a "Scan/Open" option that is particular to 
operating the scanner. Upon selection of this option, the image device manager 60 
directs the scanner to scan the current image. 

The image device manager 60 has an image device driver 64 and a set of APIs 
(application program interfaces) 66. The image device driver 64 controls operation of the 
imaging device in response to selected options in the context-specific menu. The driver 
64 is the code that facilitates communication with the imaging device over the USB 50 
and passes commands to capture an image, to read image files from the device's local 
memory, to obtain the device's properties, and so forth. 

The APIs 66 define a set of interfaces that can be used to access the functionality 
of the image device manager 60. These APIs are described in detail in an Appendix to 
this disclosure, which is incorporated herein. 

Exemplary Software Architecture 
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Fig. 2 shows a software architecture 70 for implementing the image acquisition 
system. At the kernel level, the architecture 70 includes kernel I/O drivers that include a 
bus driver to drive serial communication with the imaging device over the USB 50. 

At the user level, a device driver 74 is loaded for the particular imaging device 
connected to the computer. The device driver 74 includes a device object, an optional UI, 
and optional image processing capabilities. An image device manager object 76 is called 
to initialize and select an image device, and create the device interface. The image device 
manager object 76 performs such tasks as instantiating a device driver object 74, 
determining the device status, monitoring events from the device, and so forth. 

A COM (component object model) layer 78 exposes the device driver object 74 
and image device manager object 76 to an upper level application 80. The application 
layer 80 represents both traditional TWAIN based applications that utilize a TWAIN 
compatibility layer 82, as well as new applications that support the APIs 66. Unlike the 
traditional TWAIN model, however, the TWAIN compatibility layer 82 interacts with the 
COM-based objects 74 and 76 rather than TWAIN-based devices. 

Image Acquisition User Interface 

The image acquisition system may be incorporated into the operating system, 
exist as a set of services, or be run as a separate, self-contained application. For 
discussion purposes, the image acquisition system is described as being integrated into an 
operating system that supports a graphical user interface windowing environment. 

Fig. 3 shows an initial graphical user interface window 100 presented on the 
computer display 48. This window 100 is illustrated as the familiar "My Computer" 
screen within a browser-based windowing setting, which is well known to users of 
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Windows-brand operating systems. The "My Computer" window 100 presents a context 
for listing the major components that make up the user's PC, including disk drives, 
printers, a control panel, and networking functionality. 

Of interest to the image acquisition system is the integration and treatment of the 
imaging devices as a folder 102 organized with the other general computer components. 
This provides a convenient starting point for the user to access the imaging devices 24-30 
that are coupled to the computer 22. 

When the user activates the "Imaging Devices" folder icon 102 for the first time, 
an installation Wizard comes up to guide the user through the installation of an imaging 
device. Suppose, for example, the user has installed two scanning devices and a digital 
camera. Activating the "Imaging Devices" icon 102 navigates to a new "Imaging 
Devices" window. 

Fig. 4 shows the "Imaging Devices" window 110 presented on the computer 
display 48. The "Imaging Devices" window 110 pertains to an imaging context and lists 
the imaging devices that have been installed on the computer. In this example, the 
window lists an "add imaging device" icon 112 and icons for the three installed devices: a 
"My Scanner" icon 114 for a locally installed scanner, a "My Camera" icon 116 for the 
installed camera, and a "Jake's Scanner" icon 118 for remotely installed (via a network 
connection) scanner. Activation of the "add imaging device" icon 112 recalls the wizard 
to enable the user to install any additional imaging devices. 

The "Imaging Devices" window 110 distinguishes between devices that are 
currently available and those that are not available (e.g., offline, physically removed, 
etc.). Devices that are not available are dimmed and the user has the option of 
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uninstalling them. In Fig. 4, the second scanner identified as "Jake's Scanner" is not 
available and hence the icon 1 1 8 is dimmed. 

Activating one of the imaging devices listed in window 110 causes the image 
acquisition system to present different windows exhibiting contexts that are specific to 
the selected imaging device. Within these device-oriented windows, the image 
acquisition system presents context-specific menus that contain items or options pertinent 
and relevant to the particular imaging device. 

Fig. 5 shows a "My Scanner" window 120 that is presented upon selection, of the 
"My Scanner" icon 114 in Fig. 4. The scanner window 120 presents a. context space 122 
that pertains to the scanning context. The context space 122 has a preview scan space 
124 and a persistently- visible, context-specific menu 126 positioned adjacent the preview 
scan space within the graphical window 120. 

The context-specific menu 126 is always visible in the scanner window 120. The 
menu 126 offers options that are tailored to operating the scanner attached to the 
computer or remotely coupled to the computer via a network. While some of the options 
may be included in a context menu (i.e., a menu that appears near the pointer following a 
right moue click), the persistently-visible menu 126 lists operating specific options 
tailored to the scanner that are not included elsewhere in the user interface. 

The menu 126 includes an image type selection 128 that has a pull-down list of 
various image types from which a user may select. A non-exhaustive list of image types 
includes color photograph, black and white photograph, color line art, black and white 
line art, and text. The image types included in the pull-down list 128 are specific to the 
device. Some imaging devices may not provide support for a given format and hence the 
format is omitted in that particular list. 
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A destination selection 130 has a pull-down list of various choices on what to do 
with the scanned image. For instance, the list 130 might include using the image in an 
application, faxing the image, printing the image, copying the image to a clipboard, and 
saving the image in a file. The destination selection simplifies the output operation for 
the user. For example, selection of a choice directly affects the acquisition parameters 
and image quality without requiring the user to know what parameters to set. 

The persistently- visible context-specific menu 126 also has a "New Preview" 
command 132 that directs scanners to create a preview image of an image that is 
currently in the scanning bed. The image is presented in the preview scan space 124. 
When the image appears in the scan space 124, a preview control 134 is provided to 
allow the user to select a region of the image for a final scan. In the illustrated 
implementation, the control 134 is shown as a dashed rectangular box framing the 
picture. The user can manipulate the box 134 to capture all or less than all of the image. 
Upon selection of the region, the control can proportionally resize the image to reflect the 
size of the scanner bed and automatically configure the scanner to make the appropriate 
adjustments to capture the selected image portion. 

The menu 126 includes a "Scan/Open" command 136 to direct the scanner to 
capture the image. When this command is selected, the scanner scans the image in its 
bed. Concurrently with this scanning action, the image progressively appears in the 
preview scan space 124 to visually convey that the scanner is scanning the image. In one 
implementation, the image is progressively displayed row-by-row from top to bottom of 
the image. 

The menu 126 includes a "Save" option 138, which directs the scanner to capture 
the image as a file and store the file in the computer memory. The last listed option is a 
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"Send to" option 140, which allows the user to send the image to various locations (or 
applications) on the PC, such as for packaging in a facsimile or email. 

Fig. 6 shows a "My Camera" window 150 that is presented upon selection of the 
"My Camera" icon 116 in Fig. 4. The camera window. 150 presents a context space 152 
that pertains to the camera context. The context space 152 has a file space 154 and a 
persistently- visible, context-specific menu 156 positioned adjacent the file space within 
the graphical window 150. 

The context-specific menu 156 is always visible in the camera window 150 and 
offers options that are tailored to operating the digital camera 28 attached to the 
computer. While some of the options may be included in a context menu (i.e., a menu 
that appears near the pointer following a right moue click), the persistently-visible menu 
156 lists operating specific options tailored to the camera that are not included elsewhere 
in the user interface. 

The menu 156 is illustrated as having two tabs: a pictures tab 158 and a camera 
tab 160. Table 1 contains the options and corresponding functions available on the 
pictures tab 158. 

Table 1 

Option Function 

Open Opens a picture with a default registered 

application. 

Save in "My Pictures" folder Downloads the images from the camera 

and copies them to "My Pictures" 
directory on computer memory. 

Zoom Changes the window view and allow the 

user to select one picture at the time and 
zoom in/out of the picture once it's copied 
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locally. 



Send to 



Allows the user to send the picture to 
various locations (or applications) on the 
PC. For example, the user may choose to 
"send" the picture to an "email recipient". 



Lock on Camera 



Allows the user to lock a picture to 
prevent accidental deletion. 



Delete from Camera 



Allows the user to permanently remove 
the picture from the camera after a 
confirmation. 



Rotate to the Right 



Allows the user to. rotate the picture 90 
degrees to the right. 



Rotate to the Left 



Allows the user to rotate the picture 90 
degrees to the left. 



View Properties 



Allows the user to view properties 
associated with the selected picture(s). 



Table 2 contains the options and corresponding functions available on the camera tab 
160. 

Table 2 



Option 



Function 



Take Picture 



Triggers the camera to take a picture. 



Copy all Pictures 



Copies all the pictures to designated 
location on the PC. 



Remove all Pictures 



Deletes all pictures in the camera. 



Share 



Brings up a wizard for the local user to 
share the camera. 



Initialize Memory Card 



Enables user to initialize the storage card 
in the camera. 



View Properties 



Allows the user to view a summary of the 
camera properties. 
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The file space 154 lists files and/or folders that pertain to digital images taken by 
the digital camera. The files are the images themselves (e.g., JPG files) and the folders 
contain image files and/or other folders with image files in them. 

The file space 154 presents the files that are currently stored on the camera. In 
this manner, the user can easily view the camera memory as if it were another memory of 
the computer. The UI allows easy integration of the camera control into the familiar 
windowing environment. 

To add a picture to the file space, the user captures a picture using the "Take 
Picture" command in the camera menu 160. The picture then appears as a file in the file 
. space 154. The user can then select the image file by clicking on the file and 
manipulating the picture using the commands on the pictures menu 1 58, such as "Rotate 
to the Left", "Rotate to the Right", "Zoom", and "Send to". The user can also save the 
image file to the computer memory using the command "Save in My Pictures folder". 

Fig. 7 shows a modified "My Camera" window 170 that supports dual-mode 
cameras (i.e., video and still). The modified window 170 is presented upon selection of 
the "My Camera" icon 1 16 in Fig. 4 and is similar to the window 150 of Fig. 6 in that it 
has a context space 172 with a file space 174 and a persistently- visible, context-specific 
menu 176. However, in this modified implementation, the context-specific menu 176 
also has a video tab 178 to list options pertaining to operation of the video camera 26. 

Notice also that one of the files in the file space 174 is a play-in-place video file 
180. This play-in-place video file 180 can be actuated to play a video clip or stream 
within the small area depicted as box 180. That is, the static video icon in box 180 is 
replaced with a streaming video at the same location in the file space. Play-in-place 



13 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 



# 



video files 180 were first introduced in Media Manager, a multimedia application 
available from Microsoft. 

Table 3 contains the options and corresponding functions available on the video tab 178. 

Table 3 

Option Function 

Play Plays back a video stream from the video 

camera. 

Open Opens a video file with a default 

application. 

Capture Frame Directs the video camera to record a 

single still-image frame. 

Capture Video Directs the video camera to record a video 

clip. 

View Properties Allows the user to view a summary of the 

video camera properties. 

Other commands may be added to the menu. For instance, a "stop" command 
may be employed to halt the capture of live video. 

Image Acquisition API 

The image acquisition API 66 enables applications to manage loading and 
unloading of all imaging devices, monitor device events, query device information 
properties, create device objects, capture images using the devices, and store or 
manipulate the images after their capture. 

The interfaces are accessible by high level languages (e.g., Visual Basic) as well 
as lower level ones (e.g., C, C++, etc.). COM is a suitable interface. In this context, each 
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device is exposed as a COM object, whereby the object provides a number of methods 
and properties associated with the imaging device. 

As one exemplary implementation, there are three general objects: a device 
manager object, a camera object, and a scanner object. The objects are described 
generally below. A more detailed description of the objects and methods are provided in 
the Appendix to this disclosure. This Appendix is incorporated into the disclosure. 

The device object contains device context and status information for a physical 

device. Once a device object is created for a physical device, the physical device controls 

what device properties are available and. what values the properties may assume. There 

may be multiple device objects created for any physical device. However, a device object 

has exclusive access to a physical device before any operation (i.e., scan, take a picture, 

etc.) is performed. Exclusive access to a physical device is made available through a 

locking/unlocking mechanism. 

The device manager is implemented as three objects that perform the following 
functions: 

A CImagelnDevMgr object is used to: 

• Create a device enumerator object 

• Create a device object when given a DevicelD 

• Display UI to let a user choose a device object 

• Display UI to both choose a device and acquire an image from the chosen 
device. 

A CEnumlmagelnDevInfo object is used to: 

• Enumerate all Imageln devices on a system. For each device enumerated, 
a CImagelnDevInfo object is returned. 

A CImagelnDevInfo object is used to: 

• Query device information properties from the Imageln device. One of the 
properties, Device ID, can be used by CImagelnDevMgr to create a device 
object. 

The camera object may expose the following functions: 

• Open and close the device for communication 
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• Control the device 

• Update and read device properties 

. • Update and read picture properties 

• Download, remove, and upload pictures to device 

The scanner object may expose the following functions: 

• Open and close the device for communication 

• Control the device 

• Update and read device properties 

• Set operation intent 

Although the invention has been described in language specific to structural 
features and/or methodological steps, it is to be understood that the invention defined in 
the appended claims is not necessarily limited to the specific features or steps described. 
Rather, the specific features and steps are disclosed as preferred forms of implementing 
the claimed invention. 
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CLAIMS 

1. 



An image acquisition system comprising: 



a computer Having a memory; 



an imaging device coupled to the computer, the imaging device having a device 
memory, the imaging device capturing a digital image and storing the image on one of 
the computer memory or the device memory; 

an image device manager executable on the computer to control operation of the 
imaging device; and 

a user interface with a context space and a persistently- visible imaging mienu 
positioned within the context space, the imaging menu listing options that are particular 
to controlling the imaging device and managing images captured by the imaging device. 

2. An image acquisition system as recited in claim 1, wherein the imaging 
menu includes a capture option that directs the imaging device to capture an image and to 
store the image in the memory of the computer. 

3. An image acquisition system as recited in claim 1, wherein the context 
space lists image files stored on at least one of the device memory or the computer 
memory. 

4. An image acquisition system as recited in claim 1, wherein: 
the imaging device is a scanner; and 

the context space presented by the user interface contains a preview scan area that 
shows a preview of an image in the scanner. 
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5. An image acquisition system as recited in claim 1, wherein : 
the imaging device is a scanner; and 

the context space presented by the user interface contains a scan area that is 
initially empty prior to a time when the scanner scans an image and then progressively 
displays the image as the scanner scans the image. 

6. An image acquisition system as recited in claim 1, wherein the context 
space exhibits a play-in-place video file at a location, the play-in-place video file being 
actuatable to play a video stream at the location in the context space. 

7. . An image acquisition system as recited in claim 1, further comprising an 
operating system stored in the memory and executable on the computer, the image device 
manager being incorporated into the operating system. 

8. An image acquisition system as recited in claim 1, further comprising a 
browser stored in the memory and executable on the computer, the image device manager 
being incorporated into the browser. 

9. In an image acquisition system having a computer and an imaging device 
coupled to the computer, an image manager implemented in software stored in the 
computer comprising: 

a user interface presenting a context space of an imaging context and a 
persistently-visible imaging menu positioned within the context space, the imaging menu 
listing options that are particular to operating the imaging device and managing image 
files; and 
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an image device driver to control operation of the imaging device in response to 
selected options in the imaging menu. 

10. An image manager as recited in claim 9, wherein the imaging menu 
includes a capture option to capture an image from the imaging device, and the image 
device driver directs the imaging device to capture the image into an image file for 
storage on the imaging device or the computer in response to selection of the capture 
option. 

11. An image manager as recited in claim 9, wherein the context space holds 
image files and the imaging menu includes an option to operate on one or more of the 
image files. 

12. An image manager as recited in claim 9, wherein the context space 
exhibits a play-in-place video file at a location, the play-in-place video file being 
actuatable to play a video stream at the location in the context space. 

13. An image manager as recited in claim 9, wherein the imaging device 
coupled to the computer is a scanner and the context space of the user interface pertains 
to a scanner context and contains an area that is initially empty prior to a time when the 
scanner scans an image and then progressively displays the image as the scanner scans 
the image. 

.14. An operating system embodied on a computer readable medium 
comprising an image manager as recited in claim 9. 
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15. A file system embodied on a computer readable medium comprising an 
image manager as recited in claim 9. 

16. A browser program embodied on a computer readable medium comprising 
an image manager as recited in claim. 9. 

17. A user interface embodied on a computer-readable medium and 
executable on a computer comprising: 

a file space of a selectable context, the file space exhibiting one or more files 
and/or folders pertaining to the context; and 

a persistently-visible context-specific menu positioned within the file space 
adjacent to the files and/or folders, the context-specific menu listing options that are 
particular to the context of the file space. 

18. A user interface as recited in claim 17, wherein the files comprise digital 
image files and the folders comprise sets of digital image files. 

19. A user interface as recited in claim 17, wherein the context of the file 
space pertains to imaging devices, and the options listed in the context-specific menu 
include a command to capture digital images using an imaging device coupled to the 
computer. 
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20. A user interface as recited in claim 17, wherein the file space also exhibits 
a play-in-place video file at a location, the play-in-place video file being actuatable to 
play a video stream at the location in the file space. 

21 . A user interface as recited in claim 17, wherein the options in the context- 
specific menu change in response to changing the context of the file space. 

22. A file system embodied on a computer- readable medium incorporating the 
user interface as recited in claim 17. 

23. An operating system embodied on a computer-readable medium 
incorporating the user interface as recited in claim 17. 

24. A browser embodied on a computer-readable medium incorporating the 
user interface as recited in claim 17. 

25. For a computer-implemented scanning system having a scanner coupled to 
a computer, a user interface comprising a graphical window having a preview scan space, 
the preview scan space being initially empty prior to a time when the scanner scans an 
image, the user interface progressively displaying the image within the preview scan 
space to visually convey that the scanner is scanning the image. 
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26. A user interface as recited in claim 25, wherein the user interface 
progressively displays the image row-by-row. 

27. A user interface as recited in claim 25, wherein the user interface 
progressively displays the image currently with the scanner scanning the image. 

28. A user interface as recited in claim 25, further comprising a persistently- 
visible menu positioned adjacent the preview scan space within the graphical window, 
the menu containing options that are particular to operating the scanner. 

29. A user interface as recited in claim 25, further comprising a destination list 
that presents a user with choices on what to do with the scanned image. 

30. A user interface as recited in claim 25, further comprising a control to 
enable a user to select which portion of the image to scan in a final output. 

31. A file system embodied on a computer-readable medium incorporating the 
user interface as recited in claim 25. 

32. An operating system embodied on a computer-readable medium 
incorporating the user interface as recited in claim 25. 
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33. A browser embodied on a computer-readable medium incorporating the 
user interface as recited in claim 25. 

34. For a computer-implemented scanning system having a scanner coupled to 
a computer, a user interface embodied on a computer-readable medium and executable on 
the computer comprising: ■ " . . 

a graphical window having a preview scan space to hold a preview of the image 
to be scanned by the scanner; and 

a control to enable a user to select a portion of the image to be scanned by the 
scanner. 

35. An operating system embodied on a computer-readable medium 
incorporating the user interface as recited in claim 34. 

36. A browser embodied on a computer-readable medium incorporating the 
user interface as recited in claim 34. 

37. An application program interface for an image acquisition system, the 
application program interface being embodied on a computer-readable medium and 
having methods for performing the following functions: 

creating a device object for an imaging device; 

displaying a user interface to enable a user to choose the device object; 
displaying a user interface to enable the user to capture an image using the 
imaging device; and 
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querying the imaging device for properties. 

38. An application program interface for an image acquisition system, the 
application program interface being embodied on a computer-readable medium and 
having methods for performing the following functions: 

opening and closing a camera for communication; 

controlling the camera; and 

reading properties associated with the camera. 

reading properties associated with pictures taken by the camera; and 

manipulating pictures stored in a memory of the camera. 

39. An application program interface for an image acquisition system, the 
application program interface being embodied on a computer-readable medium and 
having methods for performing the following functions: 

opening and closing a scanner for communication; " 

controlling the scanner; and 

reading properties associated with the scanner. 

40. A computer-implemented method for execution in a graphical user 
interface windowing environment, comprising the following steps: 

presenting a set of one or more files and/or folders in a file space within a 
graphical window; 

presenting a persistently- visible, context-specific menu within the file space 
adjacent to the files and/or folders; and 
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listing options in the context-specific menu that are particular to operating on the 
files and/or folders in the file space. 

I 

41. A computer-implemented method as recited in claim 40 wherein the 
presenting step comprises the step of presenting a set of digital image files. 

42. A computer-implemented method as recited in claim 40 further 
comprising the step of operating on the files and/or folders in response to selection of an 
option in the context-specific menu. 

43. A computer- implemented method as recited in claim 40 further 
comprising the step of exhibiting a play-in-place video file at a location in the file space, 
the play-in-place video file being actuatable to play a video stream at the location! in the 
file space. 

44. A computer-implemented method as recited in claim 40 further 
comprising the following steps: 

presenting a new set of one or more files and/or folders in the file space; and 
listing new options in the context-specific menu that are particular to operating on 
the new set of files and/or folders. 

45. For a computer-implemented scanning system having a. scanner coupled to 
a computer, a computer-implemented method for executing a scanning software 
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application in a graphical user interface windowing environment, comprising the 
following steps: 

presenting a preview scan space within a graphical window, the preview scan 
space being initially empty; and 

progressively displaying an image within the preview scan space to visually 
convey that the scanner is scanning. the image. 

46. A computer-implemented method as recited in claim 45 wherein the 
displaying step comprises the step of building the image row-by- row. 

47. A computer-implemented method as recited in claim 45 wherein the 
displaying step comprises the step of building the image simultaneously as the scanner 
scans the image. 

48. A computer-implemented method as recited in claim 45 further 
comprising the following steps: 

presenting a persistently-visible menu within the preview scan space within the 
graphical window; and 

listing options in the menu that are particular to operating the scanner. 
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49. For a computer-implemented scanning system having a scanner coupled to 
a computer, a computer-implemented method for executing a scanning software 
application in a graphical user interface windowing environment, comprising the 
following steps: 

presenting a preview scan space to hold a preview of the image to be scanned by 
the scanner; and 

enabling a user to select a portion of the image to be scanned by the scanner. 
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ABSTRACT 

An image acquisition system has a computer and one or more imaging devices 
coupled to the computer. Each imaging device has a device memory and is capable of 
capturing a digital image and storing the image in its memory. An image device manager 
is implemented in software on the computer to control operation of the imaging devices. 
The image device manager presents a user interface (UI) within the familiar graphical 
windowing environment. The UI has a context space that pertains to a particular imaging 
context (e.g., scanning, photography, and video). The UI also has a persistently-visible 
imaging menu positioned within the context space that lists options particular to the 
imaging context. For example, if the context space pertains .to the digital camera context, 
the menu lists options to take a picture, store the image on the computer, send the image 
in an email, and so on. In the scanner context, the menu lists options to select an image 
type, preview an image, send the image to a particular destination, and scan the image. 
The image acquisition system also includes a set of application program interfaces (APIs) 
that expose image management functionality to applications. The APIs enable 
applications to manage loading and unloading of imaging devices, monitor device events, 
query device information properties, create device objects, capture images using the 
devices, and store or manipulate the images after their capture. 
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APPENDIX 

Imageln Device Manager 

The Imageln device manager provides interfaces for enumerating devices, querying properties of 
installed Imageln devices and creating Imageln device objects. The device manager has three 
objects. 

ClmagelnDevMgr is used to: 

• . Create an enumerator object, CEnumlmagelnDevlnfo 

• Create a device object when given a DevicelD. 

.......pisplay.UL.to let.a user choose a device. object™, t 

• Display Ul to both choose a device and acquire an image from the chosen device. 

CEnumlmagelnDevlnfo is used to: 

• Enumerate all Imageln devices on a system. For each device enumerated, a 
ClmagelnDevlnfo object is returned. 

ClmagelnDevlnfo is used to: 

• Query device information properties from the Imageln device. One of the properties, Device 
ID, can be used by ClmagelnDevMgr to create a device object. 

Device information properties are distinct from normal device properties in that they are read from 

the registry and can be queried without forcing the device object to be created. 

A program using its own methods to select an Imageln device would do the following: 

• Create a ClmagelnDevMgr object 

• Use the NmagelnDevMgr interface to create a CEnumlmagelnDevlnfo object 

• Use IEnumlMAGEIN_DEVJNFO interface to create a ClmagelnDevlnfo object for each 
Imageln device enumerated. 

• Use IPropertyStorage interface of ClmagelnDevlnfo object to inspect the device information 
properties of each device, save the Device ID property from the desired device. 

• Use the DevicelD property in UmagelnDevMgr interface to create an Imageln device object 



NmagelnDevMgr Interface 

EnumlmagelnOevlnfo 

HRE STILT UmagelnDevMgr: : EnumlmagelnDevInf o ( 
LONG lFlags, 
IEnumlMAGE IN_DEV_INFO * * ppIEnum); 

EnumlmagelnDevlnfo creates a standard enumerator for ClmagelnDevlnfo objects. The 
enumerator itself is a CEnumlmagelnDevlnfo object that has a single interface 
IEnumlMAGEIN_DEV_INFO. Applications can use this API to obtain device information properties 
from available Imageln devices. 



Specifies the type of device to enumerate. 

Enumeration interface for CEnumlmagelnDevlnfo objects. 



Parameters: 
I Flags 
ppIEnum 
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GetlmagelnDevlnfo 

HRESULT I Image InDevMgr :: Get Image InDevInfo( 

BSTR bstrDevicelD , 

IPropertyStorage** ppIPropStg) ; 

Given a device ID GetlmagelnDevlnfo returns an IPropertyStorage interface to ClmagelnDevlnfo 
objects. This API gives applications a quick way to retrieve device information properties from a 
stored device ID. 

Parameters: 

bstrDevicelD, Device ID string returned from device info object. 

ppIPropStg IPropertyStorage interface to ClmagelnDevlnfo objects. 



CreatelmagelnDev 

HRESULT IlmagelnDevMgr : : CreatelmagelnDev ( 

BSTR bstrDevicelD, 
IUnknown** ppDevice) ; 

CreatelmagelnDev creates a device object identified by bstrDevicelD and returns an IUnknown 
interface to the object. The application can use Querylnterface on this IUnknown to access the 
other interfaces on a device. 

Device ID string returned from device info object. 
IUnknown interface pointer returned. 



SelectlmagelnDev 

HRESULT IlmagelnDevMgr: : SelectlmagelnDev ( 
LONG lFlags, 
IUnknown** ppDevice) ; 

SelectlmagelnDev displays Ul for the selection of Imageln devices. When the user selects a 
device, the device object is created and an IUnknown interface is returned. The application can 
then use Querylnterface on this IUnknown to access the other interfaces on a device. Returns 
S_FALSE if the user cancels the selection dialog without making a device selection, S_OK if 
the user makes a device selection or an error value if the method fails. 

Parameters: 

Flags Operation flags 

ppDevice IUnknown interface pointer returned 



Parameters: 

bstrDevicelD 
ppDevice 
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Getlmage 

HRESULT IlmagelnDevMgr :: Get Image ( 

LONG IFlags,. 
LONG 1 Intent, 

LONG cf Format, 

STGMEDIUM* pMedium) ; 

Getlmage displays device selection Ul allowing a user to select a device. If the user selects a 
device, a device is created and device Ul is displayed to capture the image. Image data is 
returned in the pMedium structure. Image format and default image capture properties may be 
specified using the llntent and cfFormat parameters. Returns S_FALSE if the user cancels the 
selection dialog without making a device selection, S_OK if the user makes a device selection and 
t he data is transf erred or an^error value if the method fails. 

Parameters: 

I Flags Operation flags 

llntent Intent, default image capture properties 

p cfFormat Clipboard format desired by application 

k g pMedium Image is returned through this medium. 

!Q- " 
W . 

vj - • 

j EnumDestinationlnfo 

ij\ HRESULT IlmagelnDevMgr : :EnumDestinationInf o ( 

LONG IFlags, 

IUnknown* pDevice , 

H ■ IEnumIMAGEIN_DEST_INFO* * ppIEnum); 



EnumlmagelnOestlnfo creates a standard enumerator for ClmagelnDestlnfo objects. The 
enumerator itself is a CEnumlmagelnOestlnfo object that has a single interface 
IEnumlMAGEIN_DEST_INFO. Applications can use this API to obtain device destination 
properties from an Imageln device. Destination applications are registered using 
RegisterDestinationApplication. 

Parameters: 

IFlags Enumeration flags. 

pDevice Device object. If null destination applications for all devices are 

enumerated. 

ppIEnum Enumeration interface for CEnumlmagelnDestlnfb objects. 



RegisterDestinationApplication 

HRESULT IlmagelnDevMgr: : Regis terDestinationApplication( 



LONG IFlags, 
LONG .^llntent, 
IUnknown* pDevice, 

BSTR - bstrEvent, 
BSTR bs t rAppName , 

BSTR bstrCommandLine) ; 



This method is called when an application wishes to register as an Imageln destination. 
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Parameters: 

lFlags Registration flags. 

Untent Intent, default image capture properties. 

pDevice Device object If null, destination application is registered for all 

devices. 

bstrEvent Optional event name. 

bstrAppName Friendly name of Application. This name will be displayed to the user 

inUI. 

bstrCommandLine Full path to the executable for this application. Additional command 

line arguments may be added to this command 

UnregisterDestinationApplication 

HRESTUL IlmagelnDevMgr: :UnregisterDestinationApplication 
LONG lFlags, 
IUnknown* pDevice , ' 

BSTR bstrAppName) ; 

This method is called when an application that has registered an Imageln destination wishes to be 
unins tailed or no longer known as an Imageln destination 

Parameters: 

lFlags Operation flags. 

pDevice Device object If null, destination application is unregistered for all 

devices. 

bstrAppName Friendly name of Application, used to register application. 



IEnumlMAGEIN_DEVJNFO Interface 

The IEnumlMAGEIN_DEVJNFO interface is a standard OLE enumeration interface that supports 
per device enumeration of device information properties. 

Next 

HRESULT IEnumIMAGEIN_DEV_INFO : :Next ( 
ULONG celt, 
IPropertyStorage** rgelt, 
ULONG *pceltFetched) ; 

Next returns an array of IPropertyStorage interfaces to ClmagelnDevlnfo objects. Applications 
can use the returned of IPropertyStorage interfaces to obtain device information properties from 
available Imageln devices. 



Parameters: 

celt Specifies the number of elements requested, 

rgelt Address of an array in which to return the IPropertyStorage interfaces. 

pceltFetched Address of a value that receives a count of the item identifiers actually 
returned in rgelt. 
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Skip 

HRESULT IEnumIMAGEIN_DEV_INFO : : Skip (ULONG celt); 

Skip skips device objects in the enumeration. 

Parameters: 

celt Number of items to skip. 

Reset 

HRESULT IEnumIMAGEINJDEV_INFO : : Reset (void) ; 

Reset sets the enumeration back to the first device. 
Clone 

HRESULT IEnumIMAGEIN_DEV_INFO : : Clone ( 

IEnumIMAGEIN_DEV_INFO **ppIEnum) ; 

Clone creates another IEnumlMAGEIN_DEV_INFO enumeration object and returns an interface 
pointer to it. 

Parameters: 

ppIEnum Address that receives a pointer to the new enumeration object 



IEnumlMAGEIN_DEST_INFO Interface 

The IEnumlMAGEIN_DESTJNFO interface is a standard OLE enumeration interface that 
supports enumeration of device destination properties. 

Next 

HRESULT IEnumIMAGEIN_DEST_INFO : :Next { 
ULONG celt, 
IPropertyStorage** rgelt, 
ULONG *pceltFetched) ; 

Next returns an array of IPropertyStorage interfaces to ClmagelnDestlnfo objects. Applications 
can use the returned of IPropertyStorage interfaces to obtain destination information properties 
from available Imageln devices. 

Specifies the number of elements requested. 
Address of an array in which to return the IPropertyStorage interfaces. 
Address of a value that receives a count of the item identifiers actually 
returned in rgelt. 



Skip 

HRESULT IEnumlMAGEIN DEST INFO :: Skip (ULONG celt); 



Parameters: 
celt 
rgelt 

pceltFetched 
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Skip skips destination objects in the enumeration. 

Parameters: 

celt Number of items to skip. 



Reset 

HRESULT IEnumIMAGEIN_DEST_INFO : : Reset (void) ; 

Reset sets the enumeration back to the first device. 



Xlone 

HRESULT I EnumlMAGE IN_DEST_INFO : : Clone ( 

IEnumIMAGEIN_DEST_INFO **ppIEnum) ; 

Clone creates another IEnumlMAGElN_DESTJNFO enumeration object and returns an interface 
pointer to it. 

Parameters: 

ppIEnum Address that receives a pointer to the new enumeration object. 



IPropertyStorage Interface 



The IPropertyStorage interface is used to query the device information and destination properties. 
IPropertyStorage is a standard OLE interface and is documented in the OLE Programmers 
Reference. All device information properties are read only. Any attempt to modify the device 
information properties will result in a failure with access denied. The methods of this interface are: 

HRESULT ReadMultiple (ULONG, const PROPSPEC, PROP VARIANT) ; 

HRESULT WriteMultiple (ULONG, const PROPSPEC, PROP VARIANT , PROPID); 

HRESULT DeleteMultiple(ULONG, const PROPSPEC) ; 

HRESULT Re adProp e r tyName s ( ULONG , const PROPID, LPOLESTR) ; 

HRESULT WritePropertyNames (ULONG, const PROPID, LPOLESTR) ; 

HRESULT DeletePropertyNames (ULONG, const PROPID); 

HRESULT Commit (DWORD) ; 

HRESULT Revert (void) ; 

HRESULT Enum ( IEnumSTATPROPSTG* * ) ; 

HRESULT SetTimes (FILETIME const *, FILETIME const *, FILETIME const *) ; 
HRESULT SetClass (REFCLSID) ; 
HRESULT Stat (STATPROPSETSTG *) ; 



Device Information Properties 

All Imageln devices support the following basic device information properties: 

Device CLSID - The CLSID of the Imageln server for this device. 

Unique Device ID - A device ID which is unique per physical device. 
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Vendor Description 
Device Description 
Device Type 
Device Port Name 
Device Friendly Name 
Device Icon Resource 
Device Bitmap Resource 
Server Name 



- The device manufactures name. 

- A description of the device. 

- A device type constant: scanner, camera... 

- Name of the port through which the device is connected. 

- A user readable device name. 

- Resource file name and ID. 

- Resource file name and ID. 

- The name of the server where the Imageln server for this 
device is running. 
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Imageln Scanner Device Obj ect 

Imageln device objects support interfaces for querying and setting device properties, displaying 
device Ul and transferring data. Imageln devices are required to support a small number of 
standard interfaces that allow applications to deal with all devices in a common manner and 
transfer data from the devices in a manner that is native to the (COM) application. Device objects 
may also support more specialized interfaces to implement custom functions. Since the 
application has a direct connection to the device object, this architecture does not place any strict 
limits on the interfaces a device object can export. Practically speaking though, applications must 
know about an interface for it to be useful. 

IScan Interface 

ScanDIg 

HRESULT ScanDIg ( 

LONG lFlags, 
LONG llntent) ; 

ScanDIg presents the system or device Ul needed to prepare a device for scanning. If the dialog 
successfully completes, the scan object will be ready to begin data transfer via the IDataObject or 
limageTransfer interfaces. The default image capture properties may be specified using the 
optional llntent parameter. Returns S_FALSE if the user cancels the selection dialog without 
making a device selection, S_OK if the user makes a device selection or an error value if the 
method fails. 



+ Parameters: 



IFIags Operation flags 

■Intent Intent, default image capture properties 



IPropertyStorage Interface 



The standard IPropertyStorage interface is used to query and set all scan device properties. 
IPropertyStorage is a standard OLE interface and is documented in the OLE Programmers 
Reference. The methods of this interface are: 

HRESULT ReadMultiple (ULONG, const PROPSPEC, PROP VARIANT) ;. 

HRESULT WriteMultiple (ULONG, const PROPSPEC, PROPVARIANT , PROPID) ; 

HRESULT Dele teMultiple (ULONG, const PROPSPEC); 

HRESULT ReadPropertyNames (ULONG, const PROPID, LPOLESTR) ; 

HRESULT WritePropertyNames (ULONG, const PROPID, LPOLESTR); 

HRESULT DeletePropertyNames (ULONG, const PROPID); 

HRESULT Commit (DWORD) ; 

HRESULT Revert (void) ; 

HRESULT Enum ( IEnumSTATPROPSTG* * ) ; 

HRESULT SetTimes (FILETIME const *, FILETIME const *, FILETIME const *) 
HRESULT SetClass (REFCLSID) ; 
HRESULT Stat (STATPROPSETSTG *) ; 

All Imageln scanner devices support the following basic device properties: 
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Horizontal Resolution 
Vertical Resolution 
Horizontal Scan Start Position 
Vertical Scan Start Position 
Horizontal Scan Extent 
Vertical Scan Extent 
Scan Data Type 
Scan Color Depth 



- Hie horizontal resolution in DPI. 

- The vertical resolution in DPI. 

- The horizontal start position in pixels. 

- The vertical start position in pixels. 

- The width of the scan in pixels. 

- The height of the scan in pixels. 

- A data format specification constant 

- The number of bits per pixel used to specify color. 



Imageln scan devices may support additional device properties depending on hardware configuration. 



IDevPropStream Interface 

The IDevPropStream interface is used to query/set all current device properties from/to a named, 
non-volatile, registry based storage. The methods of this interface are: 

ReadDevPropStream 

HRESULT ReadDevPropStream (BSTR bstrName); 

ReadDevPropStream reads a device property stream from the specified value and initializes the 
device with these properties. The properties are per user and per device. 

Parameters: 

bstrName Name of the property stream. 

WriteDevPropStream 

HRESULT WriteDevPropStream (BSTR bstrName) ; 

WriteDevPropStream writes the current device property stream to the specified value. The 
properties are per user and per device. 

Parameters: 

bstrName Name of the property stream. 

ListDevPropStreams 

HRESULT ListDevPropStreams (BSTR *pbstrName) ; 

ListDevPropStreams lists the device property stream names present in non-volatile storage. The 
list is returned in an allocated BSTR which the application must free using SysFreeString. 

Parameters: 

pbstrName Pointer to receive a list property streams. 
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DeleteDevPropStream 

HRESULT DeleteDevPropStream (BSTR bstrName) ; 

DeleteDevPropStream deletes a device property stream from non-volatile storage. 
Parameters: 

bstrName Name of the property stream. 



IDataObject Interface 

The IDataObject interface is a standard OLE data transfer mechanism. This interface is used to provide an 
easy^and natural way for applications to transfer data from a scan device. The full IDataObject interface 
descriptidnTcan be found in the OLE2 Programmer's Reference. The methods of this interface are: 



HRESULT GetData (LPFORMATETC, LPSTGMEDIUM) ; 

HRESULT . GetDataHere (LPFORMATETC, LPSTGMEDIUM) ; 

HRESULT QueryGetData (LPFORMATETC) ; 

HRESULT GetCanonicalFormatEtc (LPFORMATETC, LPFORMATETC) ; 

HRESULT SetData (LPFORMATETC, STGMEDIUM FAR *, BOOL); 

HRESULT EnumFormat Etc (DWORD, LPENUMFORMATETC FAR *) ; 

HRESULT DAdvi S e ( FORMATETC FAR *, DWORD, LPADVISESINK, DWORD FAR *) ; 

HRESULT DUnadvise (DWORD) ; 

HRESULT EnumDAdvise (LPENUMSTATDATA FAR *) ; 



HmageTransfer Interface 



The HmageTransfer is a high performance data transfer interface. This interface uses a shared memory 
window to transfer data from the device object to the application, eliminating unnecessary data copies 
during marshalling. For Simplicity, this interface uses the same format negotiation method as IDataObject 
HmageTransfer uses two different mechanisms to transfer data.: 



Banded Transfers 

The device breaks a large image transfer up into smaller transfers, which are performed sequentially into an 
application-specified buffer. 

Data Callback 

The device does a single large transfer, while calling back to the application as the transfer progresses. 

itAllocateTransferBuffer 

HRESULT itAllocateTransferBuffer ( 
LONG lFlags, 
LONG ISize, 
ULONG hSection, 
ULONG ProcessID) ; 

Allocates a buffer to use for scanning data from the device. The buffer is mapped into the address space of 
both the client and server process. 
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Parameters: 
Flags 
ISize 
hSection 
ProcessID 



Operation flags. 

Size in bytes of the requested buffer. 
Mapped section handle 
Caller process ID 



itFreeTransferBuffer 

HRESULT itFreeTransferBuffer (void) ; 

Free the buffer created by itAIIocateTransferBuffer. This buffer is also freed when the device 
object is destroyed. 



itBeginTransfer 



HRESULT itBeginTransf er ( 
LPFORMATETC 
LONG 

IDataCallback* 



pFormatEtc, 
iFlags , 

pIDataCallback) ; 



Reset a device object context to begin an llmageTransfer. 



Parameters: 

pForfnatEtc 
IFlags 

pIDataCallback 



Format specification. 
Operation flags. 

Optional transfer progress notification entry point. 



ItGetlmage 

HRESULT i t Get Image ( 
LONG 
LONG* 
LONG* 

Perform an image transfer. 

Parameters: 
IFlags 
pISrcOffeet 
pcbWritten 



IFlags, 
plSrcOf f set , 
pcbWrittea) ; 



Operation flags. 

Source pointer for transfer. 

Actual number of bytes written during transfer. 



itGetlmageCB 

HRESULT itGetlmageCB (LONG IFlags); 

Perform an image transfer using a user specified callback. 

Parameters: 

IFlags Operation flags. 



itEndTransfer 

HRESULT itEndTransfer (LONG IFlags); 
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Cleanup a device object context after an image transfer. 

Parameters: 

Flags Operation flags. 



itQueryGetData 

HRESULT itQueryGetData (LPFORMATETC pf e) ; 

Check to see if a device supports a given format in an image transfer. 

Parameters: 

pfe Pointer to the FORMATETC structure defining the format, 

- * - : medium, and target device to use for the query. 



itEnumFormatEtc 

HRESULT itEnumFormatEtc ( 

DWORD dw, 
LPENUMFORMATETC* IpEnum); 

Create a format enumerator. 

Parameters: 

dw Reserved 

IpEnum Indirect pointer to the lEnumFORMATETC interface on the new 

enumerator object. 
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Imageln Camera Device Object 



The Imageln Camera is a hierarchical object The top-level camera object is used to get basic device 
information and also to get access to individual images or image folders. The CCameraltem object 
represents images and Image folders. 

ICamera Interface 

TakePicture 

HRESULT TakePicture () ; 

The TakePicture method instructs a camera to take a new picture. 

GetCameraRootltem 

HRESULT GetCameraRootltem (ICameraltem** pICameraltem) ; 

This method returns an interface to the root CCameraltem object Using the Icameraltem interface it is 
possible to enumerate all images on the camera. 

Parameters: 

PICameraltem Interface pointer to root camera item 

GetCameraltemByHandle 

HRESULT GetCameraltemByHandle ( 

ULONG ulItemHandle, 
ICameraltem** pICameraltem) ; 

This method returns an ICameraltem interface to the specified CCameraltem object A handle for a 
CCameraltem object can only be obtained through the ICameraltem interface. 

Parameters: 

ulItemHandle Handle to camera item, previously returned by Cameraltem 

interface 

pICameraltem Interface pointer to Camera Item specified by handle 



IFlags , 
1 Intent, 
pICameraltem) ; 

Display the camera UL UI will select an image on a device and prepare for image transfer. The UI returns a 
ICameraltem interface to a CCameraltem ready for data transfer. IDataObject or IlmageTransfer interfaces 
are then used to transfer image data. 



CameraDIg 

HRESULT CameraDIg ( 
LONG 
LONG 

ICameraltem** 
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Parameters: 

lFlags Operational flags 

llntent High level intent 

pICameraltem Interface pointer to Camera Item selected by Dig 



ICameraltem Interface 

A CCameraltem object is created for every image and directory on the camera. This is done to support full 
and flexible hierarchical image storage on cameras. A ICameraltem pointer is returned for each 
CCameraltem object ICameraltem methods are defined below. 

GetltemType 

HRESULT GetltemType (ULONG *pItemType) ; 

GetltemType returns the type of camera item the object represents. The two types of camera items are: 

1 . ItemTypeFolder - CCameraltem is a folder that may contain other CCameraltems 

2. ItemTypelmage - Ccameraltem is an image. 
Parameters: 

pltemType Item Type returned 

GetltemHandle 

HRESULT GetltemHandle (ULONG *pItemHandle) ; 

Returns a handle to the CCameraltem. This handle can later be used by the ICamera interface to get an 
interface pointer back to this object 

Parameters: 

PItemHandle Item handle returned. This handle may be used by the GetCameraltemByHandle 
method of the ICamera interface to obtain an Icameraltem pointer. 

OpenlmagePropertyStorage 

HRESULT OpenlmagePropertyStorage (IPropertyStorage** 
ppIPropertyStorage) ; 

Returns an IPropertyStorage interface to the CCameraltem object 
Parameters: 

ppIPropertyStorage Returned IPropertyStorage interface pointer. 

EnumChildltems 

HRESULT EnumChildltems (IEnumCameraltem** ppIEnumCameraltem) ; 

Creates a CEnumCameraltem object and returns a IEnumCameraltem interface to it This method only 
works if the camera item is a folder and the folder is not empty, as shown in the figure above. 
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Parameters: 

ppEEnumCameraltem Pointer to iEnumCameraltem interface. 

lEnumCameraltem Interface 

IEnumCameraltem is a standard OLE enumerator interface with the usual four methods Next, Skip, Clone 
and Reset This enumerator will return an ICameralnterface for each camera item in the current camera 
folder (that was used in the call to EnumChildltems). 

Next 

HRESULT Next( 

ULONG celt, 

ICameraltem** pp ICameraltem > 

ULONG* pceltFetched) ; 

Q Return an ICameraltem interface for each CCameraltem contained by the current folder. 

m . 

Sg Parameters: 

III . 

celt number of camera items to get 

i y ppICameraltem List of iCameraltem interface pointers returned. 

pceltFetched Number of interface pointers returned 
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Skip 

HRESULT Skip (ULONG celt) ; 
Skip celt CCameraltem objects. 
Parameters: 

celt Number of Ccameraltem objects to skip 

Reset 

HRESULT Reset (void) ; 
Begin at the first CCameraltem object 
Parameters: None 

Clone 

HRESULT Clone (IEnumCameraltem **pp IEnumCameraltem ); 
Create a new CEnumCameraltem object and return a IEnumCameraltem interface. 
Parameters: 

ppEEnumCameraltem New enumerator created to exactly match this one. 
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Camera Download Manager 



The camera download manager monitors the connection status of camera devices. When a camera device is 
connected to the system, the Download Manager will attempt to immediately download all the images from 
the camera onto the system hard disk. The camera download manager will also maintain a data base of all 
images previously downloaded from a given camera and not download images that are already cached. 

Caching images in this manner has several advantages. 

• Camera image download can be very slow, this cache prevents any image from needing to be 
downloaded more than once. 

• Applications do not need a special API to acquire images from a camera, simply wait for the download 
to complete and load the image from the file system. 

• Images are safely and automatically copied to the file system where they can easily be edited, 
archived, printed or just saved. 

In order for the camera download manager to work effectively, camera events must be detectable. For 
example, it should be easy to detect when a camera is connected or disconnected from the system. This 
should be detectable without loading the entire camera driver. Also any activity performed directly on the 
camera (through camera controls) must be reported to software so an accurate internal model of the state of 
the camera can be kept 
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Sample Code 

Get an image from an Imageln device. Use the Tmageln device manager device selection UI and the device 
image acquisition UL 

/******************************************* ****************** 

* 

* Get Image Fromlmageln 
* 

* DESCRIPTION: 

* Use the Imageln device manager to select a device and acquire an 

* image using the device UI. 
* 

* PARAMETERS: 

* pszDIBf ileName - Name of the DIB file which contain the image data. 
* 

....*...*•......■.•„/ 

HRESULT GetlmageFromlmagelndiPOLESTR pszDIBf ileName) 

{ - 
HRESULT hr; 
IlmagelnDevMgr *pl ImagelnDevMgr; 

// Get Imageln device manager object, 
hr » CoCreateInstance(CLSID_IraageInDevMgr, 
NULL, 

CLSCTX_LOCAL_SERVER , 
I ID_I ImagelnDevMgr, 
(void* * ) &pl ImagelnDevMgr ) ; 

if (SUCCEEDED (hr) ) { 
STGMEDIUM StgMedium; 

// Fill in the storage medium spec and get the image. 
StgMedium. tymed =« TYMED_FILE; 
StgMedium. IpszFileName = pszDIBf ileName ; 
StgMedium. pUnkForRelease » NULL; 
hr a pi ImagelnDevMgr- >Get image (0, 

CF_DIB, 
&StgMedium) ; 

pi ImagelnDevMgr ->Release() ; 

. } 

return hr; 

} 
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Enumerate all installed Imageln devices and get the device ID of a specific device: 

# 

* Get Device ID fromDescript ion 
# 

* DESCRIPTION: 

* Get the unique device ID of an Imageln device baaed on it's description. 
# 

* PARAMETERS : 

* pszDescription - Requested device description, from device info properties. 

* pszDevicelD - Buffer for the returned device ID. 

* cbDevicelDSize - Size of the returned device ID buffer in bytes. 

* • 

*** *.******..**..**•*•******************************************"**/ 

HRESULT GetDevicelDf romDescription ( 
LPOLESTR pszDescription, 
LPOLESTR pszDevicelD, 
UINT cchDevicelD) 

{ 

HRESULT hr; 
IlmagelnDevMgr *pIImageInDevMgr; 

if (pszDevicelD && cchDevicelD) { 
•pszDevicelD = '\0'; 

} 

else { 

return E_INVALIDARG; 

} 

. // Get Imageln device manager object, 
hr «« CoCreatelnstancetCLSID^ImagelnDevMgr, 
NULL," 

CLSCTX_LOCAL_SERVER , 

I ID_I Image InDevMgr , 

(void* * ) tpl ImagelnDevMgr ) > 

if (SUCCEEDED (hr) ) { . 

I EnumlMAGE IN_DEV_INFO *pIEnumIMAGEINJDEV_INFO ; 
PROPSPEC PropSpecCH; 

PROPVARIANT PropVarDesc [1] , PropVarlD [1] ; 
UINT cbSize; 

// Get an enumerator for the Imageln device information. 

hr » plImageInDevMgr->EnumImageInDevInfo(0, &pIEnuraIMAGEIN_DEV_INFO) ; 

if (SUCCEEDED (hr)) { 

IPropertyStorage *pIPropStg; 

ULONG Ul; 

// Enumerate the Imageln devices, getting a IlmagelnDevInfo 
// pointer for each. Use this interface to query the registry 
// based properties for each installed device, 
ul » 1; 

while ((hr » p I Enural MAGE IN_D EV_INFO - >Next ( 1 , 

fcpIPropStg, 
&ul)) « S_OK) { 

// Read the device description for the current device. 
PropSpec(0] .ulKind » PRSPEC_PROPID; 
PropSpec [0] .propid = DIP_DEV_DESC; 

hr » pIPropStg->ReadMultiple(l, PropSpec, PropVarDesc) ; 
if (SUCCEEDED (hr)) { 

// Test for a description match. 

if ( !wcacmp( PropVarDesc [0 3 .pwszVal, pszDescription)) { 
// Read the device ID. 
PropSpec [0] .propid * DIP_DEV_ID; 

hr = piPropStg->ReadMultipleTl, PropSpec, PropVarlD); 
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if (SUCCEEDED (hr) ) { 

wcancpy (pszDevicelD, PropVarID[0] .pwazVal, cchDevicelD) ; 
Pr opVariant Clear (PropVar ID) ; 

} . 

} 

PropVariantClear (PropVarDesc) ; 

} 

pIPropStg->Release() ; 
if (*pszDeviceID) { 
break; 

} 

. } 

pIEnumlMAGEIN DEV INFO->Release() ; 

> . 

plimagelnDevMgr->Release() ; 
if ( ! *pszDeviceID) { 
hr » E FAIL; 

} " 

} 

return hr; 

} 
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